home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / rcp.z / rcp
Text File  |  1998-10-20  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. rrrrccccpppp((((1111CCCC))))                                                                rrrrccccpppp((((1111CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rcp - remote file copy
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      rrrrccccpppp [ ----pppp ] [ ----vvvv ] file1 file2
  13.      rrrrccccpppp [ ----pppp ] [ ----rrrr ] [ ----vvvv ] file ... directory
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _r_c_p copies files between machines.  Each _f_i_l_e or _d_i_r_e_c_t_o_r_y argument has
  17.      one of these forms:
  18.  
  19.      +o  A local filename, _p_a_t_h, containing no :::: characters, or a \\\\ before any
  20.         ::::'s.
  21.  
  22.      +o  A remote filename of the form _r_e_m_h_o_s_t::::_p_a_t_h.
  23.  
  24.      +o  A remote filename of the the form _r_e_m_u_s_e_r@@@@_r_e_m_h_o_s_t::::_p_a_t_h, which uses the
  25.         user name _r_e_m_u_s_e_r rather than the current user name on the remote
  26.         host.
  27.  
  28.      If _p_a_t_h is not a full pathname, it is interpreted relative to your login
  29.      directory on _r_e_m_h_o_s_t.  A _p_a_t_h on a remote host can be quoted (using \\\\, """",
  30.      or '''') so that the metacharacters are interpreted remotely.
  31.  
  32.      By default, the mode and owner of _f_i_l_e_2 are preserved if it already
  33.      existed; otherwise the mode of the source file modified by the _u_m_a_s_k(2)
  34.      on the destination host is used.
  35.  
  36.      The options to _r_c_p are:
  37.  
  38.      ----pppp   Causes _r_c_p to attempt to preserve (duplicate) in its copies the
  39.           modification times and modes of the source files, ignoring the
  40.           _u_m_a_s_k.
  41.  
  42.      ----rrrr   If any of the source files are directories, _r_c_p copies each subtree
  43.           rooted at that name; in this case the destination must be a
  44.           directory.
  45.  
  46.      ----vvvv   Causes the filename to be printed as it is copied to or from a
  47.           remote host.
  48.  
  49.      _r_c_p does not prompt for passwords; your current local user name must
  50.      exist on _r_e_m_h_o_s_t and allow remote command execution via _r_s_h(1C).
  51.  
  52.      _r_c_p handles third party copies, where neither source nor target files are
  53.      on the current machine.  Hostname-to-address translation of the target
  54.      host is performed on the source host.
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      cp(1), ftp(1C), rlogin(1C), rsh(1C), hosts(4), rhosts(4).
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrrccccpppp((((1111CCCC))))                                                                rrrrccccpppp((((1111CCCC))))
  71.  
  72.  
  73.  
  74. BBBBUUUUGGGGSSSS
  75.      _r_c_p doesn't detect all cases where the target of a copy might be a file
  76.      in cases where only a directory should be legal.
  77.  
  78.      The exit status is not correct in all error cases when both source and
  79.      destination are remote; this is due to a limitation of the protocol.
  80.  
  81.      If you use _c_s_h(1), _r_c_p does not work if your ._c_s_h_r_c file on the remote
  82.      host unconditionally executes interactive or output-generating commands.
  83.      The message
  84.  
  85.           protocol screwup
  86.  
  87.      is displayed when this happens.  Put the offending commands inside the
  88.      following conditional block:
  89.  
  90.           if ($?prompt) then
  91.  
  92.           endif
  93.  
  94.      so they won't interfere with _r_c_p, _r_s_h, and other non-interactive,
  95.      _r_c_m_d(3N)-based programs.
  96.  
  97.      _r_c_p cannot handle filenames that have embedded newline characters.  A
  98.      newline character is a _r_c_p protocol delimiter.  The error message when
  99.      this happens is:
  100.  
  101.           protocol screwup: unexpected <newline>
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.